home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 266 / headstrt / headstrt.doc < prev    next >
Encoding:
Text File  |  1989-03-29  |  9.9 KB  |  217 lines
  1.  
  2.                            Head Start 1.0
  3.  
  4.                By Charles F. Johnson and John Eidsvoog
  5.                   Copyright 1989 CodeHead Software
  6.  
  7.                  Documentation by Charles F. Johnson
  8.                  Released: Sunday, February 12, 1989
  9.  
  10.  
  11.      Head Start 1.0 is a complete rewrite of the popular/infamous public
  12. domain program, STARTGEM.  Its purpose is to easily allow you to
  13. auto-boot any type of program from your AUTO folder, including GEM
  14. programs.  Head Start is much more flexible than STARTGEM; you can
  15. choose from among a list of up to 128 programs to auto-boot, using the
  16. mouse.  And it's also more sturdy than STARTGEM; Head Start will wait
  17. until all desk accessories are loaded and the desktop is fully
  18. initialized, before running the auto-boot program.  STARTGEM has an
  19. annoying habit of auto-starting programs while the desk accessories are
  20. still loading, which can lead to all sorts of interesting and colorful
  21. system crashes. 
  22.  
  23.      Head Start 1.0 also has special hooks built into it, that allow it
  24. to communicate with MultiDesk.  These hooks allow you to auto-run any
  25. shell program which replaces the desktop (such as Neodesk 2.0), and make
  26. MultiDesk wait to load its accessories until the shell program is
  27. running.  (NOTE:  you should only use this option if you don't plan on
  28. quitting the auto-run shell program to the built-in desktop.  Also note
  29. that under most normal circumstances it's not desirable to use the
  30. 'WAIT' option.)
  31.  
  32.  
  33. Copyright stuff.
  34. ----------------
  35.  
  36.      Head Start 1.0, MAKELIST.PRG, and this document are Copyright 1989
  37. CodeHead Software.  However, they may be freely distributed as long as
  38. this text file, the Head Start program file, and the MAKELIST program
  39. file are all included.  Neither this document file (HEADSTRT.DOC) or the
  40. program files (HEADST10.PRG and MAKELIST.PRG) may be altered in any way. 
  41. Copies of these files may not be sold, and this document may not be
  42. reprinted, without the express written permission of CodeHead Software. 
  43.  
  44.      We've tried to make Head Start as bug-free as possible. 
  45. Nevertheless, CodeHead Software cannot be responsible for any damages
  46. that may occur as a result of the use (or misuse) of Head Start or
  47. MAKELIST.PRG.
  48.  
  49.  
  50. Preparing to use Head Start.
  51. ----------------------------
  52.  
  53.      Head Start 1.0 is designed to run from the AUTO folder on your boot
  54. disk; therefore the first thing you should do is copy HEADST10.PRG to
  55. your AUTO folder.  If you don't already have an AUTO folder on your boot
  56. disk, you will need to create one.  Refer to your ST users' manual if
  57. you're unsure about how to do this. 
  58.  
  59.      Before re-booting your system to try out Head Start, you'll need to
  60. create the Head Start data file, which contains a list of all the
  61. programs you wish to choose from.  When Head Start runs, it looks in the
  62. main directory of your boot disk for a file called HEADSTRT.DAT.  This
  63. data file is an ordinary ASCII text file, and can be created with any
  64. text editor and most word processors, or with the included MAKELIST.PRG
  65. (see below).  It consists of the full pathnames of each program file,
  66. each on its own line.  The file can contain up to 128 pathnames, and it
  67. can also contain comments (lines that start with a semi-colon) and blank
  68. lines.  Here's an example HEADSTRT.DAT file:
  69.  
  70. ------------------------------------------------------------------------
  71.  
  72. ; Example Head Start data file
  73.  
  74. C:\FLASH.PRG
  75. A:\TIMESET.PRG
  76. XW C:\NEODESK2\NEOMASTR.PRG
  77. B:\1STWORD\1STWORD.PRG
  78.  
  79.  
  80. ------------------------------------------------------------------------
  81.  
  82.      There are two special options which can be enabled for each program
  83. in the list.  These options are set by starting the line containing the
  84. pathname with a special character, either 'X' or 'W' (or both) followed
  85. by a space.  In our example, we've set both options on the line
  86. containing the pathname C:\NEODESK2\NEOMASTR.PRG.
  87.  
  88.      The 'X' option tells Head Start to make this program the default
  89. autorun program.  When Head Start runs, the selection cursor will be
  90. placed on this filename, and it will automatically be selected for
  91. autorunning if the timeout (see below) expires.  Only one program can be
  92. marked in this manner; if more than one line in the data file contains
  93. the 'X' flag, the first one will be used.
  94.  
  95.      The 'W' option is intended to be used in conjunction with our
  96. commercial product, MultiDesk.  If the 'W' option is set, Head Start
  97. will detect the presence of MultiDesk (version 1.7 or higher) and tell
  98. it to wait to load its accessories and steal its vectors until the
  99. autorun program is actually running.  This enables MultiDesk to work
  100. in a more reliable fashion with certain "shell" programs such as Neodesk
  101. 2.0.  If you do not have MultiDesk 1.7 installed, the 'W' option has no
  102. effect.  (See below for information on upgrading to MultiDesk 1.7.)
  103.  
  104.      The easiest way to create the HEADSTRT.DAT file is with the
  105. included MAKELIST program, which lets you use the GEM file selector to
  106. create the list of pathnames, and saves the list to a file of your
  107. choice.  MAKELIST will also let you set the 'X' and 'W' options for each
  108. pathname.  When you run MAKELIST.PRG, it will display its instructions
  109. on-screen -- therefore we won't document the program here.
  110.  
  111.  
  112. Running Head Start.
  113. -------------------
  114.  
  115.      Once the data file is created, re-boot your computer with the disk
  116. which contains the AUTO folder with HEADST10.PRG in it, and the
  117. HEADSTRT.DAT file in the main directory.  If you've set everything up
  118. properly, when Head Start runs it will display a list of the filenames
  119. contained in the HEADSTRT.DAT file.  If this list doesn't appear, make
  120. sure the HEADSTRT.DAT file is in the main directory of your boot disk,
  121. and that it contains valid pathnames and follows the format described
  122. above. 
  123.  
  124.      The selection cursor (a transparent box) will be placed either on
  125. the first name in the list, or on the default autorun program (which is
  126. specified with the 'X' option - see above)).  You can move the cursor
  127. around through the list of files with either the arrow keys or the
  128. mouse.  When the box is resting on the file you wish to autorun, press
  129. the Return key or the left mouse button to select it, and Head Start
  130. will continue.  To exit Head Start without selecting any autorun
  131. program, press the Esc key or the right mouse button. 
  132.  
  133.      If you have specified a default autorun program in your
  134. HEADSTRT.DAT file (with the 'X' option) and you don't move the mouse or
  135. type any keys when Head Start runs, it will "timeout" after five seconds
  136. and exit, automatically selecting the default program.  If no default
  137. program is specified, the timeout feature is disabled.
  138.  
  139.      When you exit Head Start 1.0 with an autorun program selected, Head
  140. Start leaves part of itself in RAM.  This "resident" code then watches
  141. for the right combination of events to tell it to autorun the chosen
  142. program.  When you exit with nothing selected, Head Start 1.0 is
  143. completely wiped from memory.
  144.  
  145.  
  146. A few caveats.
  147. --------------
  148.  
  149.      Head Start works by using techniques which are highly specific to
  150. the two versions of TOS that are currently in release.  It relies on
  151. certain sequences of Line F calls which are completely undocumented by
  152. Atari.  It's not our normal practice at CodeHead Software to use
  153. undocumented techniques; but unfortunately, this is the only way to
  154. reliably autorun a GEM program with the current versions of TOS. 
  155.  
  156.      This means that Head Start will only work (at present) on the
  157. original version of TOS in ROM, or the later revision which appeared
  158. with the Mega STs.  As of this writing, TOS 1.4 has still not been
  159. released by Atari, and the current version of Head Start 1.0 will not
  160. work with beta versions of TOS 1.4.  This shouldn't really matter, since
  161. TOS 1.4 has its own method of autorunning programs.
  162.  
  163.  
  164. Head Start 1.0 and MultiDesk 1.7.
  165. ---------------------------------
  166.  
  167.      As mentioned above, Head Start 1.0 contains "hooks" which enable it
  168. to communicate with MultiDesk 1.7.  We put these hooks in because some
  169. people had reported trouble using MultiDesk with Neodesk 2.0 (from
  170. Gribnif Software), when they autobooted Neodesk with the original PD
  171. STARTGEM program.
  172.  
  173.      When you use the 'W' option described above, MultiDesk will think
  174. the autorun program IS the desktop, and you'll be able to load setups
  175. and clear accessories just as if you were on the built-in desktop. 
  176. Therefore, we don't recommend that you use the 'W' option if you plan on
  177. exiting the autorun program to the standard GEM desktop; if any of the
  178. accessories have intercepted any traps or interrupts this will probably
  179. result in a crash (sooner or later).  The proper way to exit a program
  180. which has been autorun with the 'W' option (when MultiDesk is present)
  181. is with our friend, the reset button.
  182.  
  183.  
  184. Updating to MultiDesk 1.7.
  185. --------------------------
  186.  
  187.      Registered owners of MultiDesk can upgrade to version 1.7 (which
  188. enables you to take advantage of Head Start's 'W' option) by sending
  189. your original MultiDesk disk and $5.00 to:
  190.  
  191.      CodeHead Software
  192.      P.O. Box 4336
  193.      N. Hollywood, CA 91607
  194.  
  195.      (MultiDesk is CodeHead Software's ground-breaking desk accessory
  196. loader, that lets you load up to 32 standard ST desk accessories into
  197. only *one* drop-down menu slot.  MultiDesk is highly compatible with a
  198. majority of existing ST accessories, and has a host of useful and
  199. intuitive features.  MultiDesk sells for only $29.95.  You can find it
  200. at your favorite ST dealer, or order it directly from CodeHead Software
  201. by calling our order line at (213) 386-5735.  Credit card and COD orders
  202. accepted.)
  203.  
  204.  
  205. ------------------------------------------------------------------------
  206.  
  207.  
  208. Enjoy Head Start 1.0!  (And watch for Head Start 3.0, another innovative
  209. product currently under development by CodeHead Software!)
  210.  
  211. - Charles F. Johnson
  212.   John Eidsvoog
  213.   CodeHead Software
  214.  
  215.  
  216. P.S. and *please* don't steal software!
  217.